package com.pethospital.service;

import com.pethospital.entity.PageResult;
import com.pethospital.entity.User;

import java.util.List;

/**
 * 用户服务接口
 * User Service Interface
 * 
 * @author PetHospital System
 * @version 1.0
 */
public interface UserService {
    
    /**
     * 用户登录
     * 
     * @param username 用户名
     * @param password 密码
     * @return User 用户对象，登录失败返回null
     */
    User login(String username, String password);
    
    /**
     * 用户注册
     * 
     * @param user 用户对象
     * @return boolean 注册是否成功
     */
    boolean register(User user);
    
    /**
     * 根据用户ID查询用户
     * 
     * @param userId 用户ID
     * @return User 用户对象
     */
    User getUserById(Integer userId);
    
    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return User 用户对象
     */
    User getUserByUsername(String username);
    
    /**
     * 更新用户信息
     * 
     * @param user 用户对象
     * @return boolean 更新是否成功
     */
    boolean updateUser(User user);
    
    /**
     * 删除用户
     * 
     * @param userId 用户ID
     * @return boolean 删除是否成功
     */
    boolean deleteUser(Integer userId);
    
    /**
     * 批量删除用户
     * 
     * @param userIds 用户ID数组
     * @return boolean 删除是否成功
     */
    boolean batchDeleteUsers(Integer[] userIds);
    
    /**
     * 查询所有用户
     * 
     * @return List<User> 用户列表
     */
    List<User> getAllUsers();
    
    /**
     * 分页查询用户
     * 
     * @param currentPage 当前页码
     * @param pageSize 每页大小
     * @return PageResult<User> 分页结果
     */
    PageResult<User> getUsersByPage(int currentPage, int pageSize);
    
    /**
     * 根据条件分页查询用户
     *
     * @param username 用户名（模糊查询）
     * @param realName 真实姓名（模糊查询）
     * @param userType 用户类型
     * @param status 状态
     * @param currentPage 当前页码
     * @param pageSize 每页大小
     * @return PageResult<User> 分页结果
     */
    PageResult<User> searchUsers(String username, String realName, String userType,
                               String status, int currentPage, int pageSize);

    /**
     * 根据条件分页查询用户（带排序）
     *
     * @param username 用户名（模糊查询）
     * @param realName 真实姓名（模糊查询）
     * @param userType 用户类型
     * @param status 状态
     * @param sortField 排序字段
     * @param sortOrder 排序方向（asc/desc）
     * @param currentPage 当前页码
     * @param pageSize 每页大小
     * @return PageResult<User> 分页结果
     */
    PageResult<User> searchUsers(String username, String realName, String userType,
                               String status, String sortField, String sortOrder,
                               int currentPage, int pageSize);
    
    /**
     * 统计用户总数
     * 
     * @return long 用户总数
     */
    long getTotalUserCount();
    
    /**
     * 根据用户类型统计用户数量
     *
     * @param userType 用户类型
     * @return long 用户数量
     */
    long getUserCountByType(String userType);

    /**
     * 统计今日注册用户数量
     *
     * @return long 今日注册用户数量
     */
    long getTodayRegisteredUserCount();
    
    /**
     * 检查用户名是否存在
     * 
     * @param username 用户名
     * @return boolean 是否存在
     */
    boolean isUsernameExists(String username);
    
    /**
     * 检查邮箱是否存在
     * 
     * @param email 邮箱
     * @return boolean 是否存在
     */
    boolean isEmailExists(String email);
    
    /**
     * 更新用户状态
     * 
     * @param userId 用户ID
     * @param status 状态
     * @return boolean 更新是否成功
     */
    boolean updateUserStatus(Integer userId, String status);
    
    /**
     * 更新用户密码
     *
     * @param userId 用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @return boolean 更新是否成功
     */
    boolean updatePassword(Integer userId, String oldPassword, String newPassword);

    /**
     * 更新用户密码（不验证旧密码）
     *
     * @param userId 用户ID
     * @param newPassword 新密码
     * @return boolean 更新是否成功
     */
    boolean updatePassword(Integer userId, String newPassword);

    /**
     * 重置用户密码（管理员功能）
     *
     * @param userId 用户ID
     * @param newPassword 新密码
     * @return boolean 重置是否成功
     */
    boolean resetPassword(Integer userId, String newPassword);
    
    /**
     * 验证用户输入数据
     * 
     * @param user 用户对象
     * @param isUpdate 是否为更新操作
     * @return String 验证结果，null表示验证通过，否则返回错误信息
     */
    String validateUser(User user, boolean isUpdate);
    
    /**
     * 验证密码强度
     * 
     * @param password 密码
     * @return boolean 密码是否符合要求
     */
    boolean isPasswordValid(String password);
}
